home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 037a / rest100.zip / REST100.DOC < prev   
Text File  |  1993-01-23  |  8KB  |  154 lines
  1.                                                                       1-23-92
  2.  
  3.  
  4.                                    Rest v1.00
  5.                                    (Shareware)
  6.  
  7.                               Written By John Klenk
  8.  
  9.                                   ************
  10.                                   Instructions
  11.                                   ************
  12.  
  13.  
  14.     Ok, I'm sure that you don't want to sit through a few pages of disclaimers
  15. and useless information, like you were probably expecting.  You probably just
  16. want to know what this program can do and how to use it correctly.  I'll make
  17. these instructions as simple and as brief as I can.  If you don't want to read
  18. this document, you should be able to get all the information you need by
  19. typing "rest ?" (without the quotes) from the directory in which rest.exe is
  20. located.
  21.  
  22.     Rest(short for "restore") is a command-line tape restore utility.  It is
  23. only for use with the Tape software that comes with a Colorado tape drive.  I
  24. tested it with Tape version 3.01, but unless the command-line usage of Tape
  25. changes much in future versions of it, Rest will work with them as well.  I 
  26. will most likely be updating Rest, for the main part just to correct any bugs 
  27. which I have not yet found(no serious ones I hope).  The reason that I created 
  28. Rest is that the Tape software contains a major flaw, in my view.  If you wish 
  29. to restore multiple volumes from a tape, you are basically presented with 2 
  30. choices:
  31.     
  32.     1.)  Use the Tape software in it's normal text-based graphics mode, choose
  33.          the first volume you wish to restore, wait for the volume to finish
  34.          restoring, choose the next volume, and so on.  
  35.  
  36.     2.)  Make a batch file that repeatedly calls the command-line form of the 
  37.          Tape software.  Create multiple identical lines, and simply change 
  38.          the /v=# parameter on each line.  This is what I used to do.
  39.  
  40. However, I didn't want to keep using a batch file in that manner.  I wanted to
  41. be able to use a one line instruction to restore multiple volumes, easily 
  42. specifying all of the desired volumes.  So I sat down and came up with Rest.
  43. So, the purpose of Rest is to restore multiple volumes from a tape backed up
  44. with Colorado's Tape software, all in one command line.
  45.  
  46.     So, without wasting any more of your time, here are the instructions. 
  47. (Remember, most of what is in this document can be learned by typing "rest ?".
  48.  
  49.  
  50.   Syntax is:  
  51.      
  52.   rest [/t=<directory of tape.exe>] [/#=<number of volumes to restore>]  
  53.        [/f=<first volume number to restore>] [/e=<volume number to end with>]  
  54.        [/r=<#-#> /r=<#> (range of volumes to exclude, can be used repeatedly)]
  55.        [any other parameters for tape.exe]  
  56.       
  57.        [ ] means that the parameter is optional(all parameters are optional).
  58.        < > means to replace the enclosed description with a value.
  59.  
  60.     All of the Rest switches can be used on the same command line.  The 
  61. default directory of tape.exe is c:\util\tape (simply because that is where my
  62. tape.exe is located).  If you use a different directory for your Tape soft-
  63. ware, be sure to specify it with the /t switch.  The default first and last 
  64. volume to be restored is number 1.  If you use the /#=n switch, you are tell-
  65. ing Rest that you wish to restore all of the volumes from 1 through n.  If you
  66. use the /f=n switch, you are telling Rest that the first volume to be restored
  67. is n.  The /e=n switch tells Rest that the last volume to be restored will be
  68. n.  The /r switch can be used in two different forms, and both can be used 
  69. repeatedly on the same command-line.  You can either type /r=#-#, and exclude
  70. all the volumes from the first number through the second, or you can type 
  71. /r=# and exclude a single volume.  This can be quite useful.  You can also
  72. enter any of the parameters accepted by the Tape software, EXCEPT for the /v
  73. switch.  This is due to the fact that Rest itself tells the tape.exe file 
  74. which volumes will be restored.  If you do use the /v switch, Rest will abort.
  75. Note that it is not necessary to use ANY command line parameters.  If no 
  76. parameters are used, it will have the same effect as typing "tape restore" -
  77. only volume number 1 will be restored.
  78.      
  79.      
  80.    Example of all of the Rest command line parameters as they could be used:  
  81.       
  82.             rest /#=15 /f=3 /e=13 /r=5-6 /r=8-11 /r=13 /t=d:\tape  
  83.       
  84.     Notice, that with the /# switch, you can specify a larger number of
  85. volumes than you will actually be restoring.  The /e switch will override the 
  86. /# switch, so in the above example, the /#=15 had NO effect.   Also, the /r 
  87. switch will take priority over the /f, /e, and the /# switches.  By using 
  88. /t=d:\tape, Rest will search for the tape.exe file is in the directory 
  89. "d:\tape".  
  90.       
  91.     Keep in mind that the maximum number of volumes that can be restored is 
  92. 255, so if a higher number is specified, Rest will abort.  
  93.       
  94.     The /v switch, used by the tape.exe software, will not be accepted.  
  95.       
  96.     Using /? will bring up the tape.exe help menu.  The Rest help screen will 
  97. come up if any Rest parameter was entered incorrectly or the parameter ? is 
  98. used.  
  99.      
  100.      
  101.        More examples of switches in use:  
  102.        ---------------------------------  
  103.       
  104.                /#=35  -->  Restores volumes 1 through 35.  
  105.                 /f=5  -->  The first volume to be restored will be number 5.  
  106.                /e=50  -->  The final volume to be restored will be number 50.  
  107.                /r=18  -->  Volume 18 will not be restored.  
  108.               /r=3-9  -->  Volumes 3 through 9 will not be restored.  
  109.    /r=2 /r=5-8 /r=65  -->  Volumes 2, 5, 6, 7, 8, and 65 will not be restored.  
  110.     /t=c:\util\jumbo  -->  Rest will look in c:\util\jumbo for tape.exe.  
  111.      
  112.   
  113.     Remember:  The /e switch will override the /# switch,  
  114.                                 
  115.                             AND  
  116.       
  117.                The /r switch will override the /f, /e, and /# switches.  
  118.  
  119.  
  120.     If you have typed in a valid command line, you will be presented with a
  121. list of all the volumes that you have chosen to restore.  If the list is not
  122. what you wanted, hit the Escape key at this point.  If it is what you want, 
  123. hit any other key.  In between volumes, Rest will pause for a few seconds, 
  124. giving you a chance to quit the restoration process early by hitting the
  125. escape key.  The main reason for my including this option is that the Tape
  126. software prevents the use of Control-Break to exit.  
  127.  
  128.     The only known bug in Rest v1.00 is one which I currently do not know how
  129. to fix:  If the drive to which you are restoring becomes full while restoring
  130. a volume, the Tape software will abort the restoration of that particular vol-
  131. ume, but Rest will continue to attempt to restore the other volumes.  This is
  132. not a serious problem, and you would have the same problem if you were restor-
  133. ing via a batch file, but I would like to find out how to detect the error 
  134. codes produced by the Tape software, if possible, to enhance Rest.  Of course,
  135. this problem is easily avoidable by making sure that you have plenty of space
  136. on your hard drive.
  137.  
  138.  
  139.  ---------------------------------------------------------------------------
  140.  
  141.     Rest v1.00 is shareware, and I do not demand any money for it's use.  All
  142. that I ask for is that you spread it around for everyone to use.  If you feel 
  143. that I have provided you with a useful program, and/or you have found any bugs
  144. in Rest, please feel free to leave mail to John Klenk on any major bulletin-
  145. board nets across the country.  Or, if you have Internet access, please leave
  146. me mail at:  klenk@cs.odu.edu.  I will have that address through May of 1993.
  147.  
  148.     If you would like to make a small contribution for my efforts, or if you
  149. would like to reach me through the U.S. mail, my address is:
  150.  
  151.  
  152.                          John Klenk, Jr.
  153.                          11212 Chestnut Grove Square, Apt. #313
  154.                          Reston, VA  22090